home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / mint / distrib / doc / readme.1st < prev    next >
Text File  |  1994-08-27  |  26KB  |  527 lines
  1. NOTE:  This file is the same as the readme.asc file, except that it has been
  2. edited so that there are line breaks where necessary.  The 'vi' editor didn't
  3. like the readme.asc file, which is why I created this file.  Also, references
  4. to dialog box examples are =probably= found in the readme.ps file ... 
  5.  
  6. -- David Paschall-Zimbel
  7.  
  8. ----------------------------------cut here-----------------------------------
  9.  
  10. The MiNT distribution kit - version 2.0
  11.  
  12. 1. About:
  13.  
  14. The MiNT distribution kit is a set of (currently 9) disks that attempt to make
  15. it easier to install MiNT onto hard disk. The distribution is maintained by me
  16. - Simon Gornall (sjg@unhygienix.ph.kcl.ac.uk) - and can be obtained via
  17. anonymous ftp from the one of our DECstations (phlim.ph.kcl.ac.uk). The kit
  18. will also be made available to Jeff Weiner at atari.archive.umich.edu
  19.  
  20. I lay no claim to any of the code contained within this distribution, save the
  21. programs on the install disk (setup.prg and install.prg), which are placed into
  22. the public domain with the proviso contained within their `about' dialogue. If
  23. anyone is displeased with the manner of this distribution, because I have used
  24. their programs without due recognition, or because I have not paid sufficient
  25. attention to their distribution conditions, I would ask them to get in touch
  26. with me at the above address. If we can't resolve the matter I will remove the
  27. program(s) from the distribution kit.
  28.  
  29. Contained within the distribution kit are:
  30.  
  31.     *    MiNT 0.95.
  32.     *    MinixFS 0.55.
  33.     *    Gcc 2.2.2 - includes the mbaserel and pcbaserel addressing.
  34.     *    Bellcore Windows MGR.
  35.     *    GNU utils including sed, fileutils, etc.
  36.     *    Init 1.0 - the multiuser extension to MiNT.
  37.     *    Nroff-compatible manual system similar to un*x
  38.     *    Many MiNT-aware shells (tcsh, bash, ash, sh, mintshel)
  39.  
  40. You will require an ST(e) with at least 1Mb ram, a free HD partition of
  41. anything up to 14Mb, and ~500k on C:\ You will also require at least a 720k
  42. drive. If there is sufficient demand from 360k drive owners then I will try to
  43. convert the kit for the smaller disk size.
  44.  
  45. As and when new software appears, it will be incorporated into the distribution
  46. as a patch disk. The interface to both the main installation and the patches
  47. will be the same program - install. This is a point-and-click interface for the
  48. selection of which programs to install, with the collection of individual
  49. related programs / files into subsets. For example, the GCC distribution is in
  50. three parts, the GCC header files, the GCC libraries, and the GCC binaries.
  51. These may be selected by clicking on the relevant lines in the selection
  52. window.
  53.  
  54. The kit comes on 9 disks currently. There are 8 data disks which contain
  55. subsets. The ninth disk is the install disk. It contains 2 programs that aid in
  56. the installation of the kit. The first is SETUP, the second INSTALL. The
  57. purpose of SETUP is to get the system into a state in which the program INSTALL
  58. may be used. Since INSTALL is a general installation program, it knows nothing
  59. of what filesystem it is using etc., all this is left to SETUP to get right.
  60. There is still the occaisional bug in both setup and install, but they are of
  61. the 'annoying' rather than 'critical' variety. For example, setup sometimes
  62. minit's a disk twice, but no harm is done. And install sometimes reads garbage
  63. for a configuration. A quit and restart solves this.
  64.  
  65. 2. Architecture:
  66.  
  67. The nine disks are labelled (informatively!) as disk1 ... disk9. Disk 1 is the
  68. install disk. It contains the installation programs Setup and Install. The disk
  69. also contains necessary programs that get placed in /bin and some for /etc. It
  70. additionally installs the TOSwin accessory, and MiNT 0.95 together with the
  71. MinixFS filesystem.
  72.  
  73. The rest of the disks are subset disks. A quick rundown of what is on what disk
  74. follows ...
  75.  
  76.  
  77. Disk 2:    
  78.  
  79. Fileutils: Eric Smith's port of some of the GNU file utilities. This is almost
  80. a mandatory subset, as it contains ls.ttp - how you get a disk directory  under
  81. a shell.
  82.  
  83. Bash:  The GNU Bourne-again shell. (A clone of sh, the bourne shell). Quite a 
  84. nice version of sh, but quite large as well. It contains extensive online help,
  85. which is useful for beginners.
  86.  
  87. Tcsh:    The recommended shell for those with lots of memory. This is a  clone
  88. of csh,  the C shell, with lots of additions.Unfortunately it is very big,
  89. taking around 350k to run. This will be greatly relieved with the introduction
  90. of MiNt 0.96, which allows two identical programs to share the same code
  91. segment, so only one copy of the code is kept in memory when two identical
  92. programs are being run. A shell is the prime example of a multiply- run
  93. program.
  94.  
  95.  
  96. Disk 3:    
  97.  
  98. bin1:    This is a collection of binaries I've made over some time. I'm not sure
  99. where most of them have come from, so I've lumped them all together.  If you
  100. intend to use shells, then this is more or less a mandatory install.
  101.  
  102.  
  103. Disk 4:    
  104.  
  105. gcc222b: The GCC 2.2.2 binaries. All the latest stuff that has support for MiNT
  106. 0.96's sharable-text stuff as detailed above. Note that no g++ compiler is
  107. included.
  108.  
  109. gcc222i: The include files for the GCC compiler. This holds the MiNT includes
  110. as well as the standard GCC ones.
  111.  
  112. Disk 5:    
  113.  
  114. gcc222l: The GCC 2.2.2 libraries. This includes the 'b' libraries that
  115. support the shared-text MiNT 0.96 facility, as well as the normal libraries.
  116.     
  117. docs: Miscellaneous documentation. Lots of it. Includes manual pages, readme
  118. files for programs, anything that doesn't fit somewhere else.
  119.  
  120.  
  121. Disk6:
  122.  
  123. futil2:    A more up to date version of the GNU fileutils.
  124.  
  125. rg10:    A program + docs that let you run GEM programs from within the tty
  126. interface of MiNT. For those who don't use the TOSwin environment.
  127.  
  128. tpipe:    A program similar to tee in bin1, that lets you split unix pipes into
  129. two.
  130.  
  131. sed:    The GNU sed package. It lets you apply editing commands to a file (sed
  132. stands for Stream EDitor). A very useful un*x tool.
  133.  
  134.  
  135. Disk 7:    
  136.  
  137. mnt95utl: MiNT utilities release 0.95. Provides programs such as 'ps' for
  138. reporting processes currently running, 'top' which shows which process is
  139. getting what amount of cpu etc.
  140.  
  141. akpbin:    Andrew Pratt's utilities. These are similar to the GNU fileutils, but
  142. use \ rather than / as a directory separator. I prefer /, so I use GNU utils,
  143. and so I don't know whether these work as well as the GNU ones, There are more
  144. GNU utils, and they always use /, so I suggest using the GNU utils.
  145.  
  146. cpx: This is a .cpx file which shows what processes are running. You need
  147. Atari's Xtensible control panel to run this.
  148.  
  149. ksh: The Korn shell. Sworn by, by many. Alas, similarly sworn at by many. I'm
  150. going to sit on the fence and say make up your own mind. I don't think it's as
  151. friendly as tcsh, but more friendly than sh. Also, it's not as big as tcsh. A
  152. good compromise ?
  153.  
  154. man3: A manual formatting package that uses nroff ( a un*x typesetting
  155. language) to produce readable manual pages from their standard un*x form. This
  156. needs some elements of the bin1 subset to be installed -  namely
  157. /usr/local/lib/nroff/tmac.an, and /usr/bin/more.ttp
  158.  
  159. elvis: A vi clone. Vi is the original un*x editor (it stands for VIsual), it
  160. is actually a line-based editor pretending to be a screen-based editor. For
  161. this reason, most people prefer different editors. Still, under proper un*x you
  162. sometimes have to use it (for example in the special case vipw, which vi's the
  163. passwd file)
  164.  
  165. jove: Jonathon's Own Version of Emacs. A reasonably complete editor, which is
  166. my personal choice. Emacs is a screen editor, but some of the keys are a little
  167. esoteric. Documentation is included.
  168.  
  169.  
  170. Disk 8:
  171.  
  172. Ash: Ash is 'A SH clone', which you may or may not wish to install over /bin/sh
  173. that is already in /bin. Docs (and a manual page) are included.
  174.  
  175. Init: Init is the multi-user extension to MiNT that makes it behave as though
  176. it were a 'proper' un*x box, even down to the boot sequence. The /bin/sh is the
  177. one that is installed as standard on the system. If you use multimnt.cnf, then
  178. you must have installed this subset.
  179.  
  180.  
  181. Disk 9:
  182.  
  183. mgr: Bellcore windows Manager. This is a windowing system developed for early
  184. Sun un*x boxes. It is also available for the Pd un*x clone Linux. Now more or
  185. less superseded by TOSwin - which allows GEM programs